package com.ytclub.subject.infra.basic.service;

import com.ytclub.subject.infra.basic.entity.SubjectInfo;

import java.util.List;

/**
 * 题目信息表(SubjectInfo)表服务接口
 *
 * @author makejava
 * @since 2023-12-19 20:31:56
 */
public interface SubjectInfoService {

    /**
     * 通过ID查询单条数据
     *
     * @param id 主键
     * @return 实例对象
     */
    SubjectInfo queryById(Long id);

    /**
     * 新增数据
     *
     * @param subjectInfo 实例对象
     * @return 实例对象
     */
    SubjectInfo insert(SubjectInfo subjectInfo);

    /**
     * 修改数据
     *
     * @param subjectInfo 实例对象
     * @return 实例对象
     */
    int update(SubjectInfo subjectInfo);

    /**
     * 通过主键删除数据
     *
     * @param id 主键
     * @return 是否成功
     */
    boolean deleteById(Long id);

    /**
     * 分页查询所有符合条件的题目数量
     *
     * @param subjectInfo 查询条件
     * @param categoryId  分类id
     * @param labelId     标签id
     * @return 符合条件的题目数量
     */
    int countByCondition(SubjectInfo subjectInfo, Long categoryId, Long labelId);

    /**
     * 分页查询所有符合条件的题目
     *
     * @param subjectInfo 查询条件
     * @param categoryId  分类id
     * @param labelId     标签id
     * @param start       开始位置
     * @param pageSize    每页数量
     * @return 符合条件的题目列表
     */
    List<SubjectInfo> queryPage(SubjectInfo subjectInfo, Long categoryId, Long labelId,
                                int start, Integer pageSize);

    /**
     * 查询贡献题目数量
     *
     * @return 贡献题目数量列表
     */
    List<SubjectInfo> getContributeCount();

    /**
     * 查询题目id游标
     *
     * @param subjectId  题目id
     * @param categoryId 分类id
     * @param labelId    标签id
     * @param cursor     游标
     * @return 题目id
     */
    Long querySubjectIdCursor(Long subjectId, Long categoryId, Long labelId, int cursor);
}
